home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
bbs_soft
/
drtrk107.zip
/
DOORTRAK.DOC
< prev
next >
Wrap
Text File
|
1993-03-22
|
7KB
|
248 lines
DOORTRAK v1.7
By Wayne Gay
Thee Landing Z*O*N*E BBS
256:101/2@MXBBSNET (NEC)
1:3401/5@FIDONET
1-206-336-5915(bbs)
14.4 v32bis MNP
Mt. Vernon, Washington
Description:
Doortrak is a simple program. It will keep track of the number
of times a door is entered. Also it will keep track of door users
and how many doors they have entered.
It does this with a call from the door calling batchfile.
Has been tested using the Xtern_dos and the Xtern_erlvl calls from
Menus.ctl.
Doortrak is not limited to doorgames! It can be used to trak any
drop from the BBS to a door. IE: Timebanks, Callback Verifiers,
or any other program that is called from Maximus's menus.ctl using
the xtern_???? formats...
Setup: NEW
Setup is fairly simple. I will try to give examples where possible.
First thing you'll need to do is edit the DOORTRAK.CFG to your suit
your needs. The Sample included in this archive explains the setup
for the configuration.
In the directory with DOORTRAK Type : DOORTRAK SETUP
SETUP PROGRAM: is now automated with the doortrak.cfg file...
Setup: UPGRADE
You can upgrade doortrak v1.06 with this version(v1.07) without loss
of data from the data files, most of the time(see doortrak.sam
for details).
1) UNarj the drtrk107.arj file Over the old files!
( The Sample .cfg file is now called doortrak.sam.
This will preserve your old .cfg for editing )
2) READ THE DOORTRAK.SAM file. This is where you'll find most of the
new changes!! It won't work with the old .cfg setup!!!
3) If your multinode, you'll need to go into the .bat files for the
doors and change the 2nd argument according to the multinode
setup in a later section.
Usage:
Using the program is almost as simple as the setup.
Doortrak Defaults to lastuser.bbs. This is created only on
single node bbs's. If you have more than One Node of Maximus
Running then you must use the Multinode paramaters, because
Maximus will create lastus00.bbs for node one instead. Even if you
only plan to use this for one of the nodes and not all.
Using the Xtern_Dos exit from Maximus:
In the batch file for the door, either before the door is run or
after it's done running Change the current directory to the directory
with doortrak.exe.
then call doortrak with the door code as the paramater,
IE: ( door calling batch file example )
......
cd \rgdoor ( change to the door directory )
rgdoor ( run the door )
cd\bbs ( change to the directory doortrak is in )
doortrak rgd ( Run DOORTRAK with "rgd" as the paramater )
or for Multinode
doortrak rgd 05 ( Run DOORTRAK with "rgd" as the paramater, for
node 6 )
...... ( go on to bbs )
Using the Xtern_erlvl exit from Maximus:
In the bbsbatch file you need to call DOORTRAK in the door subroutine
either before or after the door is run.
IE: ( bbscalling batch file example )
......
:rgdoor
cd\rgdoor ( change to the door directory )
rgdoor ( run the door )
cd\bbs ( change to the directory doortrak is in )
doortrak rgd ( Run DOORTRAK with "rgd" as the paramater )
or for Multinode
doortrak rgd 05 ( Run DOORTRAK with "rgd" as the paramater, for
node 6 )
...... ( go on to bbs )
Bulletin Maker:
The bulletin maker can be run after each door or in the nightly
maint. ( I suggest the nightly, but it's up to you ).
After Each Door is Run:
Simply run DOORTRAK with the bulletin paramater after the call
with the door code.
IE:
.....
doortrak bulletin
.....
!!REMEMBER!! This creates a MECCA style file. To View it in Maximus,
you'll need to compile it with MECCA.
In The Nightly Maint.:
Simply change to the directory DOORTRAK is in, and run DOORTRAK
with the bulletin paramater.
IE:
.....
cd\bbs
doortrak bulletin
mecca c:\bbs\misc\bulletin.mec
.....
Resetting the Counters:
This will clear the counters for the doors as well as the users.
it will ask you if you really want to do it before it will clear
them.
This feature is for those of us who want to reset them on a monthly
basis.( Or weekly or whenever..)
IE: ( Example call to reset the counters )
doortrak reset
..... !!! NEW feature !!!!
Adding doors:
This feature will allow you to add new doors to the existing list,
without losing data on the old doors. No more need to reset
everything to add new doors to the list.
All you need to do is add the door information( as stated above )
to the "END" of the list of doors in your doortrak.cfg file.
Make sure the new doors follow the old doors. You can add as many
as you'd like up to the maximum.
Once you've added the proper lines to the .cfg file then type:
doortrak dooradd
Thats all there is to it...
Multinode Usage:
Doortrak is now usable for multi-node BBS's on all nodes using
Maximus.
To use it on a multinode bbs, simply set it up as usual for 1 node,
then from node 1 Use : DOORTRAK ??? 00
^^^ ^^
^^^ ^^ 2 digit node number(in hex)
^^^
^^^ 3 digit doorcode
then from node 2 Use : DOORTRAK ??? 01
^^^ ^^
^^^ ^^ 2 digit node number(in hex)
^^^
^^^ 3 digit doorcode
...
...
...
then from node 9 Use : DOORTRAK ??? 08
^^^ ^^
^^^ ^^ 2 digit node number(in hex)
^^^
^^^ 3 digit doorcode
The 2 digit node number must be in hex format!
IE: node #1 is 00 : node #16 is 0f : Node #24 is 17
and it MUST be 2 digit!!!
This paramater is only used for the counting portion of the
program, so it is only used when you use the doorcode paramater.
It must always be the 2nd argument, following the 3 digit code.
This option creates 1 bulletin, and 1 data file only. It doesn't
create seperate bulletins for each node or keep track of use by
node. Only totals of all nodes.
Limitations:
This program is currently capable of handling up to 100 doors
and 1000 users. I expect this to be large enough. Don't worry if
you have more than 1000 users, unless they all use the doors,
The program only adds the doorusers names to the database as
they use them, without duplicating any of them.
Registration:
Since I put my time into the building and ever improving of this
program, I feel a small fee should be payed for it's continued
use. So I ask you to send me $5.00, in return, I'll send you a
registration key, which will show registered in the bulletin, as
well as enable the function to adjust the length of the bulletin.
Please report all bugs to me via netmail at the addresses above.
ANY SUGGESTIONS for the improvement of this program will be gladly looked
into.
Enjoy (I hope) this program....
Thanks to Brian Pirie for the use of his Registration Key System Version 2.20
Maximus is a product from Scott Dudley ( Thanks!! )